Wikilinks and Embeds

中文: 中文 · Relationship Graph · Libraries and Files

Wikilinks are the core of Inimark’s “thinking” layer, with Obsidian-familiar syntax.

Basic links

[[Welcome]]
[[Welcome|custom label]]
[[Markdown Syntax#Tables]]
[[Markdown Syntax#Callouts|jump to Callouts]]

Live:

• Plain: Welcome

• Alias: Open English MOC

• Heading: Markdown Syntax › Callouts

• Heading + alias (outside tables): works as [[Note#Heading|label]]

• Cross-language: 中文欢迎

Typing [[ opens autocomplete (not inside ![[ image/note embeds). Notes are indexed by path without extension, and also resolve by basename (shallower paths win on ties). Heading anchors should match the full heading text exactly (including parentheticals), e.g. [[Everyday Workflows#Long-form writing (essays, reports, chapters)]].

Do not put [[note|alias]] or [[note#h|alias]] inside a Markdown table cell. The alias | is also the table column separator, so the link is split mid-way and looks “broken”. Use a link without an alias in tables, or write the aliased link in normal paragraphs / lists.

Autocomplete habits

Typing [[ (or inserting an empty wikilink via command) opens candidates immediately. Moving the caret into an existing [[…]] later does not reopen the list — it appears again only when you edit inside the brackets.

Unresolved links use a stronger / dashed underline treatment so you can spot missing targets. Fix the title, create the note, or remove the link.

Embeds

Note embeds

![[Markdown Showcase Card]]

Rendered:

Use embeds for reusable snippets, MOCs, and definition cards inside long notes.

Image embeds

![[photo.png]]

Common raster/vector types render as image embeds when the file resolves in the library. Prefer vault-relative assets — Images and Attachments.

Avoid cyclic embeds (A embeds B embeds A) — painful to read and publish.

Light PKM pattern

1. One hub / MOC note that mostly lists [[children]].

2. Concept notes stay short; link outward instead of duplicating.

3. Embed a “definition card” where a long essay needs the same block.

4. Review neighbors in Relationship Graph local mode weekly.

This help vault’s MOC-English Docs is the living example.

Outlinks and backlinks

Lists appear in the Relationship Graph panel; unresolved outlinks are marked. The graph visualizes the same index.

Index

The library keeps a link index (cached as .inimark/link-index.json):

1. Parse [[…]] from Markdown files

2. Build / refresh link-index

3. Feed autocomplete, Graph, and Publish href resolution

See Data Directory.

Rename and rewrite

On rename / move, Inimark can rewrite [[links]] elsewhere (including #heading and |alias suffixes):

Configured under Settings → Editor (link update on move); operations start from Libraries and Files.

Not (fully) there yet

Compared with Obsidian:

• Block refs [[note#^id]] as a full system

• Inline #tag parsing + themed chips

• Tags sidebar pane (counts, note children, sort / expand / filter)

• Search-by-tag operators and taxonomy views

Hover preview

The editor can show a note preview card for [[wikilinks]]. Choose the trigger under Settings → Editor → Wiki link preview:

See Roadmap and Feature Comparison.

Prev: Libraries and Files · Next: Search Bookmarks Outline